Harness Engineering 學習筆記 Ep-7
Ep-2 講了 Hooks 的觀念,Ep-6 引出了 MCP 的雛形,這一集把兩者真正落地進 template — 寫出兩個 PreToolUse hook 把 HARD 規則變成「動不了」的決定性約束,並用 .mcp.json 示範怎麼把外部工具(資料庫、GitHub)接進 sub-agent 的能力範圍。
Ep-2 講了 Hooks 的觀念,Ep-6 引出了 MCP 的雛形,這一集把兩者真正落地進 template — 寫出兩個 PreToolUse hook 把 HARD 規則變成「動不了」的決定性約束,並用 .mcp.json 示範怎麼把外部工具(資料庫、GitHub)接進 sub-agent 的能力範圍。
Ep-4 做了 sub-agents、Ep-5 做了 slash commands,這一集補上 Harness 的最後一塊拼圖 — Skills。本篇釐清 Sub-agent 與 Skill 到底差在哪、為什麼 Claude Code 把 slash commands 併進了 skills,並動手做一個 dep-auditor 來示範「Sub-agent + Skill 合用」的經典模式。
上一篇番外把 Nx workspace 從零搭起來,但很多人會問 — 為什麼要用 Nx?它跟一般 monorepo 工具(Turborepo、Lerna、pnpm workspace)差在哪?對 Claude Code 開發又有什麼特別好處?本篇用 nx.dev 官方論述為基底,把 Nx 的核心能力與適用情境一次講清楚。
claude-harness-template 內的 Nx workspace 是怎麼從零搭建出來的?本篇是一份完整可重現的指令清單 — 從 create-nx-workspace、生 NestJS server / Next.js client、加 lib,到 NestJS 與 Next.js 兩種不同的 port 設定模式,照著跑就能複製出同樣的骨架。
Sub-agent 解決了 Context Firewall,但還有一個更大的問題沒處理 — Agent 寫的程式碼,跟你腦袋裡想要的東西一直「飄」。本集導入 2026 最熱門的方法論 Spec-Driven Development(SDD),把 /spec、/plan、/implement 三個 slash command 加進 claude-harness-template,從此每個 feature 都有一份可被 review、可進版控的「契約」。
Ep-3 介紹完 claude-harness-template 計畫,這一集正式動工。本篇先講清楚 Sub-agent 與 Context Firewall 的核心觀念,然後直接導覽 template 裡 6 個專為 Nx + NestJS + GraphQL + Next.js 設計的 sub-agent,並提煉出四條跨 agent 共用的設計模式。
前面三集我們把 Harness Engineering 的世界觀、AGENTS.md 與 Hooks 都學了一輪,理論到此告一段落。從這一集開始,我們要把學到的東西實體化 — 動手打造一份名為 claude-harness-template 的開源模板,專為 Nx + NestJS + GraphQL + Next.js 設計,讓你 clone 之後直接用 Claude Code 開發整個系統。
本篇將深入介紹 Harness 中威力最大、也最危險的元件 — Hooks(生命週期鉤子)。從 Anthropic 在 2026 年 1 月正式推出的 12 個生命週期事件、PreToolUse 的封鎖機制、Exit Code 2 的決定性意義,到一份能套用在大型 NX Monorepo 的生產級 hook 設定,徹底搞懂怎麼用 hook 把「拜託 Agent」變成「不做到就動不了」。
本篇將深入介紹 Harness Engineering 中最基礎也最容易被誤用的元件 — AGENTS.md,從這個格式的起源、被超過 60,000 個專案採用的標準寫法,到 ETH Zurich 研究揭露的「寫太多反而更糟」殘酷數據,最後手把手帶你寫出一份精簡有效的 AGENTS.md。
本篇將介紹 2026 年最熱門的 AI 工程概念 — Harness Engineering,從 Mitchell Hashimoto 提出的起源、核心公式 Agent = Model + Harness,到 Prompt、Context、Harness 三層工程的差異,帶你理解為什麼這個詞會在短短九十天內成為整個 AI 產業的共同語言。